home *** CD-ROM | disk | FTP | other *** search
/ The Java Starter Kit / The Java Starter Kit (ISBN 1-57521-097-5D)(Cafe Lite and Symantec)(1996).ISO / cafelite / readme.txt < prev    next >
Text File  |  1996-01-29  |  17KB  |  427 lines
  1. README for Symantec CafΘ Lite
  2. =================================================================
  3. Copyright (c) 1996 by Symantec Corporation. All Rights Reserved.
  4.  
  5.  
  6. ABOUT THE "README.TXT" FILE
  7. =================================================================
  8. This file provides essential information on installing and using 
  9. Symantec CafΘ Lite.
  10.  
  11. [To print this file from Notepad on NT 3.51, please change the
  12. default fixed font (do Edit | Set Font) to any regular 12-pt. font, 
  13. such as MS Serif or Arial.  The default font is not a problem in 
  14. Windows 95 Notepad or WordPad.]
  15.  
  16.  
  17. The sections are as follows:
  18.  
  19. * What is Symantec CafΘ Lite?
  20.  
  21. * What You Need
  22.  
  23. * Installing Symantec CafΘ Lite
  24.  
  25. * Building and Using Java Projects
  26.     - Using the Java Demos
  27.     - Using AppExpress
  28.     - Generating New Projects Manually
  29.     - Running Java Applets and Applications
  30.     - Organizing Your Java Projects
  31.  
  32. * Important Points, Tips, and Workarounds
  33.  
  34. * Documentation
  35.  
  36. * Where to Go from Here
  37.  
  38. * Differences Between Java Beta 1 and Beta 2
  39.  
  40.  
  41. WHAT IS SYMANTEC CAF╔ LITE ?
  42. =================================================================
  43.  
  44. Symantec CafΘ Lite is a set of tools that allow Windows developers 
  45. to edit, build, run, and debug Java applications within the 
  46. Symantec Integrated Development and Debugging Environment, on 
  47. Windows 95 and Windows NT 3.51.  This version supports Sun 
  48. Microsystems Java Release 1.0.
  49.  
  50. This product includes all elements necessary to build Java applets 
  51. and stand-alone applications, but is a subset of the full version 
  52. of Symantec CafΘ.  The full version also includes a Class Editor, 
  53. Hierarchy Editor, a Visual Debugger, and more.  
  54.  
  55. Get complete information on the full version at 
  56. http://www.symantec.com/lit/dev/javaindex.html
  57.  
  58. This is a special early-release version of the product.
  59. Please read the limitations in "Important Points, Tips, and 
  60. Workarounds" below, and send any comments you have, or 
  61. requests for more information, to javainfo@symantec.com.
  62.  
  63.  
  64. WHAT YOU NEED
  65. =================================================================
  66.  
  67. * An IBM Personal Computer or 100-percent compatible
  68.  
  69. * 16MB RAM
  70.  
  71. * Windows 95 or Windows NT 3.51
  72.  
  73. * CD-ROM Drive
  74.  
  75. * 25-60 MB free hard disk space, depending on cluster size
  76.  
  77.  
  78. INSTALLING SYMANTEC CAF╔ LITE
  79. =================================================================
  80.  
  81. With the Symantec CafΘ Lite CD in your CD-ROM drive, 
  82. run [d]:\setup.exe -- where [d] is the drive letter for your 
  83. CD-ROM drive.
  84.  
  85. The install wizard will guide you through the simple installation; 
  86. just use the Next button to move forward through the steps.  
  87.  
  88. If you do not specify another location, the installer will install 
  89. Symantec CafΘ Lite into C:\Cafe.
  90.  
  91. Installation onto your hard drive will take from 2 to 8 minutes, 
  92. depending on the speed of your system.
  93.  
  94. When the completion dialog appears, press OK to restart and 
  95. allow the necessary changes to take effect. (On Windows 95, 
  96. the changes are in C:\autoexec,bat; on Windows NT, see 
  97. Control Panel | System.)
  98.  
  99. Note:  to uninstall Symantec CafΘ Lite,
  100. on Windows 95, use the Add/Remove Programs control panel;
  101. on Windows NT, run the uninstall icon in the Symantec CafΘ Lite 
  102. program group.
  103.  
  104. Note that Uninstall will not remove any files created in the 
  105. Cafe tree after installation -- i.e., sample projects, etc.
  106. Also, Uninstall does not remove the Program Group.
  107.  
  108.  
  109. BUILDING AND USING JAVA PROJECTS
  110. =================================================================
  111.  
  112. We suggest that you start by using and examining one of the 
  113. demo projects. The section below uses the ArcTest project as 
  114. an illustration.  Later, you can use AppExpress to generate 
  115. new Java applications, or generate projects manually.
  116.  
  117. Using the Java Demos
  118. -----------------------------------------------------------------
  119. Launch Symantec CafΘ Lite
  120. on Windows 95, from the Start | Programs menu;
  121. on Windows NT, from the Symantec CafΘ Lite program icon.
  122.  
  123. You'll see the Symantec CafΘ Lite startup screen. 
  124.  
  125. Choose Project | Open
  126. Open the ArcTest demo project, located in 
  127. Cafe\java\demo\ArcTest and named arctest.prj.  
  128.  
  129. Choose Project | Rebuild All
  130. The Java compiler will start up, process the ArcTest.java source 
  131. file, and produce the runtime class file ArcTest.class and some 
  132. additional classes in the ArcTest directory.
  133.  
  134. Choose Project | Execute Program
  135. After a brief pause, the ArcTest applet will appear and run.
  136.  
  137. Note:
  138. The first time you a run a Java application after installing, 
  139. you will see an initial copyright notice from Sun Microsystems. 
  140. To accept the terms and use the Java software on your computer, 
  141. click on Accept. 
  142.  
  143. ==> Also please read  Running Java Applets and Applications, below.
  144.  
  145.  
  146. Using AppExpress
  147. -----------------------------------------------------------------
  148. In Symantec CafΘ Lite, AppExpress offers three application types: 
  149. Java Applet, Java SDI, and Java Console.  These are extremely 
  150. simple examples to demonstrate Java applications.
  151.  
  152. This is how to create new simple Java projects using AppExpress:
  153.  
  154. Choose Project | New
  155. You may fill in a project name or leave it blank, in which case 
  156. AppExpress will later assign a default name. Select a directory, 
  157. check 'Use AppExpress' and click Finish.
  158.  
  159. Generate an application
  160. On The AppExpress main dialog select one of the three Java 
  161. application types and click Finish.
  162.  
  163. Build and execute program as in Using the Java Demos, above.
  164.  
  165. Please note the following limitation:
  166.  
  167. In Symantec CafΘ Lite, the AppExpress names are preassigned, 
  168. and everything has the same name: "Simple." (The file Simple.java 
  169. contains the class Simple.)
  170.  
  171. You can name the project whatever you like (the default project 
  172. name is - you guessed it - "Simple"), but you can't edit the 
  173. class names or file names within AppExpress.
  174.  
  175. ==> Also please read  Running Java Applets and Applications, below.
  176.  
  177.  
  178. Generating New Projects Manually
  179. -----------------------------------------------------------------
  180. If you have existing Java source code, or you are writing some, 
  181. you can use ProjectExpress to generate your own projects manually; 
  182. just specify either Applet or Console.  A "Console" app is a Java 
  183. stand-alone application, which may be either a true console (such
  184. as the AppExpress Java Console example) or a graphical windowing
  185. application (such as the AppExpress Java SDI example).
  186.  
  187. The Java source files (.java) contain the source code for your 
  188. Java classes. At build time, the compiler produces a Java class 
  189. file (.class) with the same basename as the source file. 
  190.  
  191. If your project is of type Applet, you need to write the HTML file 
  192. to invoke your applet.  See the demo projects for examples.
  193. The .html file supplies the link that allows your Java applet to 
  194. be launched and debugged within the Symantec IDDE. 
  195.  
  196. ==> Also please read  Running Java Applets and Applications, below.
  197.  
  198.  
  199. ==> Running Java Applets and Applications
  200. -----------------------------------------------------------------
  201. Background information:
  202.  
  203. Java applets are called from Hypertext links, such as links in 
  204. internet Web pages.  The links are written in editable text using 
  205. the Hypertext Markup Language (HTML).  
  206.  
  207. Java applets such as ArcTest are invoked by running appletviewer.exe 
  208. on an HTML file.  (Appletviewer then runs the Java interpreter on 
  209. the class file specified in the .html file.)  
  210.  
  211. In the ArcTest project, if you open example1.html in the editor, 
  212. you can see the format for invoking an applet from an HTML file.  
  213.  
  214. Java stand-alone applications such as the AppExpress Java Console 
  215. or Java SDI are invoked by running java.exe (the Java interpreter) 
  216. on a .class file.
  217.  
  218.  
  219. When you choose Execute Program in Symantec CafΘ Lite:
  220.  
  221. If the project is of type Applet, the Symantec Environment runs 
  222. appletviewer on the HTML file specified in the Project Arguments 
  223. dialog, or if the project arguments field is empty, on the 
  224. basename of the current project plus the extension .html. 
  225.  
  226. If the project is of type Console (Java stand-alone application),
  227. the Symantec Environment runs the Java interpreter on the class 
  228. file specified in the Project Arguments dialog. The default entry 
  229. in Project Arguments is the basename of the current project.
  230.  
  231. If your project does not conform to the above default naming,
  232. simply edit the Project | Arguments field as appropriate.
  233.  
  234. ==> Also see  Organizing Your Java Projects, below, for runtime 
  235. considerations involving CLASSPATH.
  236.  
  237.  
  238. Organizing Your Java Projects
  239. -----------------------------------------------------------------
  240. Background information:
  241.  
  242. In java the package statement is used to organize your source 
  243. (*.java) and class (*.class) files. The compiler, the interpreter, 
  244. and the appletviewer can then use this organization to find files.
  245.  
  246. The package statement in a java source file indicates that all of 
  247. the classes in that file make up part of the package.
  248.  
  249. The import statement is used to access classes that are defined 
  250. in other files.
  251.  
  252.  
  253. In order to use the package and import statements, your files must 
  254. be located properly on your drive.  The easiest way to make sure 
  255. of this is to organize your project's files as follows.
  256.  
  257. 1. In the project directory place source files that have no 
  258. package statement.
  259.  
  260. 2. For source files that contain a package statement, build a 
  261. directory structure under the project directory that mirrors the 
  262. structure of the package name.  So for a source file containing 
  263. the statement
  264.     package  COM.Symantec.Alebach;
  265. create the directory structure COM\Symantec\Alebach under the 
  266. project directory. Then place the source file in the directory 
  267. Alebach.
  268.  
  269. This should be sufficient for most projects.  If you need to do 
  270. something different, please continue reading.
  271.  
  272. The general principle is that a java source file with a package 
  273. statement must go in a directory structure matching the package 
  274. name.  So the file containing
  275.     package COM.Symantec.Alebach;
  276. must be in the directory COM\Symantec\Alebach.
  277.  
  278. Now, in a default installation, this directory structure can be 
  279. rooted either in the project directory, or in C:\Cafe\java\lib. The 
  280. reason is simply that the default CLASSPATH is  .;C:\Cafe\java\lib .
  281.  
  282. So if the project directory is C:\dev\myproj, and foobar.java 
  283. contains the above package statement, valid default locations are
  284. C:\dev\myproj\COM\Symantec\Alebach\foobar.java
  285. C:\Cafe\java\lib\COM\Symantec\Alebach\foobar.java
  286.  
  287. If you want COM\Symantec\Alebach rooted in a different directory, 
  288. you simply need to add that other directory to the classpath for 
  289. this project:  state the full classpath in the Class Path field in 
  290. Project | Settings | Directories.  So if you wanted to use C:\temp 
  291. as a root you would place the following string in Class Path:
  292.     .;C:\Cafe\java\lib;C:\temp
  293. (This passes a command-line switch that overrides the environment
  294. setting of CLASSPATH. Thus you need to restate the full classpath,
  295. not simply the additional directory.)
  296.  
  297. For a more complete description of the package and import 
  298. statements and their association with CLASSPATH, please refer 
  299. to the Java Language Specification., Section 5.
  300.  
  301. ==> Runtime implications for .class files:  Not surprisingly, the 
  302. same restrictions on location apply to .class files as to their 
  303. source files.  The default behavior of the compiler is to put its 
  304. output (.class) files in the same directory as the source files.  
  305. If this is the case, then given the instructions above, everything 
  306. will work.
  307.  
  308. However, if the compiler is given a different output directory, 
  309. it will root the correct directory structure for the .class files 
  310. in that specified output directory, BUT that directory is not
  311. automatically added to the CLASSPATH.  You have to restate the
  312. classpath with the additional root directory just as was discussed 
  313. above, into Project | Settings | Directories: Class Path.
  314.  
  315.  
  316.  
  317. IMPORTANT POINTS, LIMITATIONS, TIPS, AND WORKAROUNDS
  318. =================================================================
  319. Symantec CafΘ Lite requires you to run under either Windows 95 or 
  320. Windows NT 3.51.
  321.  
  322. File names and class names must be identical in spelling and CASE.
  323. This is a requirement of the Java compiler and interpreter.
  324.  
  325. The applet class specified inside the .html file must be identical 
  326. in spelling and CASE to the class name in the .java file.
  327.  
  328. There is currently no graphical debugger for Java. When you choose
  329. "Start/Restart Debugging" the IDDE launches the Sun command-line 
  330. debugger.
  331.  
  332. If you attempt to debug, you MUST have TCP/IP installed.  
  333. If not, the Sun command-line debugger will hang.
  334.  
  335. Symantec CafΘ Lite projects must not have names containing spaces.
  336.  
  337. The Java compiler currently will not run from a WIN95 shared 
  338. drive.  The symptom is the same as if CLASSPATH were not set 
  339. (i.e., compiler complains that it can't find the classes). This 
  340. problem is under investigation and we hope to have a fix soon.  
  341. Symantec CafΘ Lite can be run from a Netware volume.
  342.  
  343. Some of the Sun Demo programs using sound are not well behaved 
  344. if you are running a machine that does not have a sound card.  
  345. You may have to use Ctrl-Alt-Delete to terminate a misbehaving 
  346. java applet if this happens.
  347.  
  348.  
  349. AppExpress
  350. -----------------------------------------------------------------
  351. The Java SDI sample is not fully functional. Only the menu items 
  352. Help | About and File | Exit have complete code behind them. The
  353. file open and save-as dialogs do not function correctly at this 
  354. time.
  355.  
  356.  
  357. Compiler support
  358. -----------------------------------------------------------------
  359. The compiler does not accurately report the number of lines compiled.
  360.  
  361. Certain Java compiler switches are not currently supported in the 
  362. IDDE.  For more information you may want to run the Java compiler, 
  363. javac.exe, directly from the command line.
  364.  
  365.  
  366. Earlier versions of Java
  367. -----------------------------------------------------------------
  368. Earlier Java releases from Sun have different class names and 
  369. functionality in comparison with the current release. For more 
  370. information please refer to Sun's http site at http://java.sun.com.
  371.  
  372.  
  373. DOCUMENTATION
  374. =================================================================
  375. The folder Sun Docs on the CD contains the latest Java 
  376. documentation available from Sun when this CD was mastered.  
  377. The most up-to-date Java documentation is always available at 
  378. Sun's web site.
  379.  
  380. Most of the files are in HTML and can be viewed with your favorite
  381. browser, such as CyberJack or NetScape. This includes the current 
  382. API and Programmer's Guide.  The Java Language specification is 
  383. provided as a postscript file. It can be printed on any PostScript 
  384. printer or viewed with utilities such as GhostScript.
  385.  
  386.  
  387. WHERE TO GO FROM HERE
  388. =================================================================
  389. There is a host of information available at http://java.sun.com.
  390.  
  391. Visit us at Java Central:  
  392. http://www.symantec.com/lit/dev/javaindex.html
  393.  
  394. For additional information about Symantec Java support, 
  395. please contact javainfo@Symantec.com.
  396.  
  397.  
  398. DIFFERENCES BETWEEN SUN JAVA BETA1 AND BETA 2
  399. =================================================================
  400. Symantec CafΘ Lite supports Sun's Java 1.0 release including 
  401. the final Java 1.0 API. This API is compatible with Netscape 2.0 
  402. Beta 4 and later versions.
  403.  
  404. There is now an empty finalize() method in Object.
  405.  
  406. The definition of clone in Object is now as follows:
  407. protected native Object clone() throws CloneNotSupportedException;
  408. Thus if a class has not implemented the interface Clonable, a call 
  409. to clone will fail and give the error CloneNotSupportedException.
  410.  
  411. Errors previously reported as warnings are now errors, and must be 
  412. handled in your code.
  413.  
  414. The meaning of the 'protected' modifier has changed slightly.
  415.  
  416. Contravariant return types are not supported. Overriding methods 
  417. must have the same return type as the overridden method.
  418.  
  419. Loading classes from zip files is now supported by both the 
  420. compiler and the runtime class loader.
  421.  
  422. There have been several bug fixes, security improvements and API
  423. changes since the BETA 1 release.
  424.  
  425. All of these changes are described more completely at Sun's web 
  426. site:  http//java.sun.com/JDK-beta2/changes.html.
  427.